home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / laston44.zip / LASTON43.DOC < prev    next >
Text File  |  1991-10-13  |  16KB  |  282 lines
  1.  
  2.                         LASTON  Version 4.3
  3.                   Copyright 1991 Douglas DeLonay
  4.                     SYSOP of The Home of ZIGGY
  5.                            (414)264-3220
  6.  
  7.     Graphics screen design-there are now 3 user definable screens for
  8.     LASTON. They consist of 3 lines each..
  9.     in following format....
  10.  
  11.     *****name/handle**************From*******baud*****time-on***Date**
  12.     *                  *                  *        *          *      *
  13.     ******************************************************************
  14.     ^                  ^                  ^        ^          ^      ^Column 68
  15.  line 1            column 21          column 41   column 50   column60
  16.      the 3 files are named LASTON.ANI, LASTON.ASC, and LASTON.SCR..
  17.   The above would be an example of a screen design for no graphics.
  18.   The screen must be 68 colomns and 3 rows to show what you want to
  19.   surround the information about last callers..No more than 3 lines!
  20.     For the ASC and ANSI screens you should first design your ASC screen
  21.   as above.. when you got it the why you want it you can start adding the
  22.   color codes for the ANI screen.. Use a ANSI draw program such as THEDRAW
  23.   to add color to the ASC file to make it a ANSI file. Only Normal ANSI is
  24.   allowed. No animation.
  25.              make sure you have NO SPACES in the first and last lines of
  26.   the screen as that will throw your screen out of wack..
  27.                   also remember 68 colomns and the spaces between info
  28.   dividers...  look at the included sample screens to help guide you..
  29.        only 3 lines each!
  30.  
  31.      LASTON can now use the DORINFO1.DEF file!.. DORINFO1.DEf users can
  32.   disregard the LASTON.SCR and LASTONCM.SCR(comment file, look ahead) as
  33.   DORINFO1.DEF only detects for 2 choices-ANSI or not ANSI. Only the *.ANI and
  34.   *.ASC screen files apply to DORINFO1.DEF users.
  35.     Some of the commands listed do not apply to dorinfo1.def users. Commands
  36.   that DO NOT apply to DORINFO1.DEF users will have a "**" next to them. For
  37.   commands available to you always make sure you include the following command.
  38.   Dorinfo1.def users must use the commandline "DOR".. i.e.
  39.  
  40.         LASTON DOR
  41.  
  42.        It will build a LASTON.DAT file from the dorinfo1.def file, adding to it
  43.   untill it reaches the default 10 users for unregistered version. You'll have
  44.   to run it a few times as above before you notice the laston screen starts to
  45.   build. You will have to run it as above as a log-on program to keep an
  46.   updated callers list. You can also run it at a menu for users to view without
  47.   updating the callers log- refer to the MENU command below.
  48.  
  49.     If you don't use the DAT file and get an MOT ENOUGH USERS IN CALLERS.LOG
  50.   message you can use the LOGP/n command to increase the amount of the
  51.   callers.log the program reads. By default LASTON has n=5, which means it
  52.   reads 500 bytes for every user you list in LASTON. In the unregistered
  53.   version it starts reading 5,000 bytes from the end of the file. The default
  54.   setting should be good for most setup's. If you get the above mentioned error
  55.   try testing it at slightly higher setings till the error disappears. you
  56.   might try something like
  57.  
  58.         **         LASTON LOGP/7
  59.  
  60.     If you have very small amount of events and startup's and shutdowns you
  61.   could try decreasing the the number to increase speed, though I wouldn't
  62.   recommend lowering it. Decreasing it wouldn't increase speed that much. A
  63.   setting of LOGP/0 would read the entire file. Setting it too high will also
  64.   read the whole file, say you set n=400 and your callers.log has only 300,000
  65.   bytes in it. If you use the DAT command you don't need to worry about this.
  66.   It will read the entire CALLERS.LOG the first time to set up the LASTON.DAT
  67.   file, and after that it doesn't need the callers.log anymore.
  68.  
  69.     More versatility for LASTON!!.. The LASTON.DAT file is back, but only if
  70.   you want it!! To use the LASTON.DAT file just enter DAT on the LASTON command
  71.   line, as follows
  72.  
  73.           **       LASTON DAT
  74.  
  75.     This will cause LASTON to make a LASTON.DAT file on the first run then read
  76.   and update it thereafter. The major benifit to using the DAT file option is
  77.   speed. On my XT for the default 10 user list it cut the display time by 2-3
  78.   seconds, which is a pretty decent percentage. Of coarse the disadvantage
  79.   (to some) is that you have to run it in FIRST.BAT to update the LASTON.DAT
  80.   file.
  81.     Of coarse since the .DAT file is back the MENU command is back also. When
  82.   using the .DAT file and you want to run LASTON from a menu you must put the
  83.   command on the LASTON command line. as follows, The MENU command assumes use
  84.   of the LASTON.DAT file
  85.  
  86.              LASTON MENU
  87.  
  88.           You can add a 3 line comment to LASTON.. this is optional. To add
  89.   a comment simple write a 1 to 3 line file in exactly the form you want it to
  90.   appear. LASTON will not center, and spaces are accepted. To make an ANSI
  91.   comment simple use THEDRAW or similar program to add colors and attributes
  92.   you want. The file names are LASTONCM.SCR for the pure text or ascii file,
  93.   and LASTONCM.ANI for the ANSI comment file. To have LASTON add the comments,
  94.   just add COMMENT to the command line..  NO ANIMATION lowed in ANSI files!!
  95.  
  96.            i.e.     C:\RYBBS\LASTON COMMENT
  97.  
  98.     The Time display has the option to display in 24 hour military format,
  99.   or in the 12 hour AM/PM format. AM/PM format is on by default.to change to
  100.   24 HR format just add "24HR" to the command line. i.e.
  101.  
  102.              C:\RYBBS\LASTON 24hr
  103.  
  104.     LASTON has a screen pause option. Just add Pn to the command line to
  105.   to pause screen at end of display n seconds. i.e.
  106.            LASTON P5
  107.       will pause screen approximately 5 seconds after screen is displayed.
  108.   default is o seconds.
  109.     LASTON screen is now user abortable. NEW (P)ause, (C)ontinue, or (S)top
  110.   option to accomadate those speed demon users!... SYSOP can also pause, stop
  111.   the display for a remote user if local echo is on.
  112.  
  113.      Laston will show as many callers as memory and size of callers.log will
  114.      allow to your system in the form..(DORINFO1.DEF users doesn't use
  115.      callers.log).
  116.  
  117.           Name   * City state  * baud rate * time logged on*Date(month and day)
  118.  
  119. **   LASTON will now adjust the number of users shown if callers.log doesn't have
  120.      enough users, or memory isn't sufficient to list amount of callers you specify.
  121.                Must register to change amount of callers listed.
  122.                 unRegistered form will show the last 10 callers
  123.  
  124.      The DOS command line option allows for easy run from DOS without playing
  125.   with curruser.bbs(x). Will make your LASTON.CFG file for you registered users.
  126.     unregistered users can still make one and be ready when they register. Will
  127.   give you the option to use default CURRUSER.BBS(x) or DORINFO1.DEF file..
  128.   Curruser.bbs file is whatever file from last user is. curruser.x is hard coded
  129.   in the program. It will no longer show the caller that has just logged on as
  130.   the last user on.
  131.  
  132.   A command line option in the registered and unregistered version
  133.   is the local screen off mode... put OFF in the command line to stop echo
  134.   to local screen.. will still show on local screen when you are on locally.
  135.   to turn off local echo just put in FIRST.BAT file like so..
  136.  
  137.  
  138.               LASTON OFF
  139.  
  140.  
  141.   Local echo is on by default..I would recomend having it off if you run 
  142.   a XT since this will speed up the display to your users..
  143.      In the registered version you will need to make a .CFG file.
  144.                 If you want the options that is.
  145.      call it LASTON.CFG  < use DOS command line option to make this file.>
  146.             0
  147.             The Home of ZIGGY
  148.             yellow
  149.             cyan
  150.             magenta
  151.             cyan
  152.             white
  153.             red
  154.             101
  155.             4 mNEW/d,5 e
  156.  
  157.             To have LASTON make your .CFG file for you simple type in
  158.                        C:\RYBBS\LASTON DOS
  159.              at the command line!.. and answer the questions!
  160.    the first line is for your registration number which activates the rest of
  161.      the registered options.
  162.    the second line is for your BBS name. whatever you put here will replace
  163.      the <UNREGISTERED> string in the header.
  164.    The third line is the color your BBS name will be displayed in.
  165.    the forth line is the Name color.
  166.    the fifth line is the City,State color.
  167.    the sixth line is the baud rate color.
  168.    the seventh line is the time called color.
  169.    the eighth line is for the DATE color.
  170.    the ninth line is maximum amount of users to list in LASTON.dat.
  171.       it shoule be one more than the maximum you want to display. Enter a
  172.       number even if you don't plan on using the LASTON.DAT file option.
  173.    the tenth line is for chosing display options by security.. you can chose
  174.      to not have certain security level entered in the list-'e' command.
  175.      to not have the screen display to certain users-'d' command.
  176.      to have users marked as '-NEW'-'m' command.
  177.         NEW.. you can now mark as anything you want.. to mark as new just type
  178.         in NEW right after the 'm' command ending the string with a '/'.. to
  179.         mark a certain security as a subscriber you might enter 'mSUB/' as part
  180.         of the display option for the security level...make it short as the
  181.         name will get truncated to make room for the string you enter to mark
  182.         the user security with. Maximum length accepted is 10 characters.
  183.      there is a 255 character limit to the amount of security selections you
  184.      can make. it must be in the format above.. security level followed by a
  185.      space followed by display options followed by a comma if there is more
  186.      security selections. if you make no selection just enter a 0 with no
  187.      preceding characters or characters following it.
  188.  
  189.    the colors accepted are- Black, red, green, yellow, blue, magenta
  190.    , cyan, and white.  the colors must be spelled correctly as above with
  191.    no extra spaces or punctuation allowed!
  192.    in the header.. also the option to change the # of users the program shows.
  193.   as many users as your memory capacity will allow with the registered version!
  194.  
  195.     LASTON /15 OFF
  196.     MUST have the '/' before number of callers to display with no spaces.
  197.     this will list 15 callers and turn off local echo... 10 callers is on
  198.     by default. Unregistered users don't get this command line option-get
  199.     default 10 user listing.
  200.       The screen will clear on the local screen when RyBBS regains control,
  201.     but remains on the remote screen. When on locally the screen will pause
  202.     till you hit <ENTER> to give you a little time to look it over.
  203.  
  204.                           LASTON DOS
  205.  
  206.       Use the DOS parameter to run from dos when setting up screen etc.. Also
  207.     will ask you if you want to create a .CFG file.. This is only needed for
  208.     Registered version. When you get your registration number use the DOS
  209.     parameter and answer yes to set up .cfg file. Fill it out EXACTLY as asked
  210.     and it will create your LASTON.CFG file for you.
  211.      The program will search for these files(CURRUSER.BBS, CALLERS.LOG,
  212.     LASTON.CFG) in the currrent dir and in the path.
  213.        LASTON /35 OFF     -unregistered version leave out '/35'..
  214.     This would list the last 35 callers to the remote user and turn off local
  215.     echo...
  216.  
  217.        LASTON now has direct node support. All you need is the LASTON command
  218.     line and when run from a menu use %NODE!
  219.   **       i.e.   SRUN,6,6,*  [P]revious callers  *,*Laston %NODE
  220.                                                      ^Batch file
  221.        In the batch file for RyMULT users only use %1 on the command line so
  222.     LASTON can find the correct node-without it it will assume single user and
  223.     abort when a CURRUSER.BBS(x) isn't found.. i.e.
  224.  **                        LASTON %1 [parameter] [etc]..
  225.       the %1 is a MUST for RyMULT users! other parameters are optional.
  226.          You must use a post V6.8 RyBBS RyMult for it to work from FIRST.BAT
  227.     as 6.8 and earlier does not pass the NODE number to FIRST.BAT . This is more
  228.     reliable than previous version of finding NODE number. make sure you DELETE
  229.     your CURRUSER.BBS if you have it laying around from a previous version file
  230.     before converting the .bat file! or it will use the same CURRUSER.BBS file
  231.     over and over again! Node version can now be run from DOS. NOW run's on
  232.     COM's 1 - 4!!!! it uses the 'Standard' addresses for COM3 & COM4-$3E8 &
  233.     $2E8 respectively. If you use other address for COM3 & COM4 let me know
  234.     what they are and I can make a special copy with them for you-if you
  235.     register, I've put to much into this little project with very little
  236.     return..  I need money for tuition badly!!
  237.  
  238. easy command line referance section
  239.      LASTON Pn        <pause screen n seconds>
  240.      LASTON COMMENT   <will display appropriate comment file.>
  241.      LASTON OFF       <Turns off local display for faster remote display>
  242.      LASTON /n        <registered version only. Display n users>
  243.      LASTON DOS       <Use to create .CFG file when register or to run
  244.                        from dos>
  245.      LASTON 24HR      <displays time in 24 Hour military time>
  246.      LASTON DOR       <Uses the DORINFO1.DEF user file instead of CURRUSER.(x)>
  247. **   LASTON %1        <A must for Multi node users- Takes the correct node #>
  248. **   LASTON LOGP/n    <only set if you don't use DAT command and you get a NOT
  249.                        ENOUGH USERS IN CALLERS.LOG error. n=5 by default.
  250.                        Increase from n=5 till error disappears>
  251. **   LASTON DAT       <Tells laston to make(if not present) and use the
  252.                                                          LASTON.DAT file>
  253.      LASTON MENU      <For use with DAT command when run from a menu>
  254.         All parameters are optional EXCEPT for the %1 parameter for multi-node
  255.      users. Parameters can be used together in any order.
  256.  
  257.      REGISTRATION BENIFITS are- Add your BBS name to header, get rid of the 3
  258.   lines of advertisement before list(will still display copywrite notice after
  259.   display), ability to change amount of users listed, ability to mark users as
  260.   new, paid, or whatever you want, change field colors- i.e. change color of
  261.   name, baud, etc...knowing you helped a starving student!
  262.  
  263.        This program was written for RyBBS only on a 286 AT and tested
  264.     on a XT clone... it was tested using COM ports COM1 & COM2 & COM3..
  265.          Can also use Dorinfo1.def file!!
  266.       It was also run successfully on a 386-25... if you test this on
  267.     anything else successfully not listed here- other machines Please let me
  268.     know!..  why not try some other programs such as
  269.             ANSED, DOORECHO!...... available on RYBBS homebase!(RyBBS specific)
  270.            To register for the added options send $15 to
  271.                   Douglas DeLonay
  272.                   P.O. BOX 72112
  273.                   Milwaukee, WI 53212
  274.  
  275.            along with any suggestions or comments you may have.
  276.            also indicate if you want you registration number sent
  277.            by US mail, E-MAIL on Homebase or on The Home of ZIGGY
  278.                        (414)264-3220
  279.  
  280.                  Thanks for your support!
  281.  
  282.